Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 17 - File Objects / File Objects Reference

Constants

File Mode Flags

QuickDraw 3D defines a set of file mode flags to specify a file object's current file mode. The file mode is returned to you when you call Q3File_OpenRead, Q3Open_Write, or Q3File_GetMode.

typedef enum TQ3FileModeMasks {
   kQ3FileModeNormal             = 0,
   kQ3FileModeStream             = 1 << 0,
   kQ3FileModeDatabase           = 1 << 1,
   kQ3FileModeText               = 1 << 2
} TQ3FileModeMasks;

Constant descriptions

kQ3FileModeNormal

Set if the file object is organized in normal mode. A file object is in normal mode if it contains a table of contents that lists all referenced objects in the file object. Normal mode is the most compact metafile representation.

kQ3FileModeStream

Set if the file object is organized in stream mode. A file is in stream mode if there are no internal references in the file. You can use stream mode for reading or writing unidirectional streams, but a file in stream mode is usually larger than a file in normal mode.

kQ3FileModeDatabase

Set if the file object is organized in database mode. A file object is in database mode if the file object lists in its table of contents all shared objects contained in the file object, whether or not those objects are multiply referenced.

kQ3FileModeText

Set if the file object is a text file. The file object is read as text, using tokens and behaviors appropriate for text file objects.

You can combine the kQ3FileModeText mask with any of the other masks, and you can combine the kQ3FileModeStream and kQ3FileModeDatabase masks in a single file mode.